home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / fx / dmFXMergeResources.z / dmFXMergeResources
Encoding:
Text File  |  1998-10-20  |  5.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddmmmmFFFFXXXXMMMMeeeerrrrggggeeeeRRRReeeessssoooouuuurrrrcccceeeessss((((3333ddddmmmm))))                                ddddmmmmFFFFXXXXMMMMeeeerrrrggggeeeeRRRReeeessssoooouuuurrrrcccceeeessss((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddmmmmFFFFXXXXMMMMeeeerrrrggggeeeeRRRReeeessssoooouuuurrrrcccceeeessss - load and merge plugin resources with those of the
  10.      parent application
  11.  
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ffffxxxx____uuuuttttiiiillllssss....hhhh>>>>
  15.  
  16.      DDDDMMMMssssttttaaaattttuuuussss ddddmmmmFFFFXXXXMMMMeeeerrrrggggeeeeRRRReeeessssoooouuuurrrrcccceeeessss
  17.            (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr**** rrrrffff ))))
  18.  
  19.  
  20. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  21.      _r_f   The name of the X resource file.
  22.  
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      To support internationalization it is desirable for all user interface
  26.      strings to be defined in locale-specific X resource files.
  27.      ddddmmmmFFFFXXXXMMMMeeeerrrrggggeeeeRRRReeeessssoooouuuurrrrcccceeeessss is a utility function which plugins may use to merge
  28.      their own X resource files with those of the current application.
  29.      Plugins may use the merged resources to define a locale-specific name
  30.      and, if desired, locale-specific labels for their own user interface
  31.      components.  Even if you only ever intend to support English it may still
  32.      be desirable to use a resource file since it allows simple changes to the
  33.      user interface without any need to recompile.
  34.  
  35.      Internationalized applications (such as Moviemaker) will search the
  36.      merged resource database for a unique plugin identifier and use the value
  37.      of that resource to replace _P_K__N_a_m_e in user-interface components.
  38.  
  39.      The unique plugin identifier is constructed from the plugin prefix, name
  40.      and type as follows (with any non alpanumeric characters replaced by
  41.      ``_''):
  42.  
  43.           _P_K__U_n_i_q_u_e_P_r_e_f_i_x ``_'' _P_K__N_a_m_e ``_Video_Filter''
  44.  
  45.           _P_K__U_n_i_q_u_e_P_r_e_f_i_x ``_'' _P_K__N_a_m_e ``_Video_Transition''
  46.  
  47.           _P_K__U_n_i_q_u_e_P_r_e_f_i_x ``_'' _P_K__N_a_m_e ``_Audio_Filter''
  48.  
  49.           _P_K__U_n_i_q_u_e_P_r_e_f_i_x ``_'' _P_K__N_a_m_e ``_Other''
  50.  
  51.      For example, if a video filter has a prefix of ``SGI'' and a name of
  52.      ``Brightness & Contrast'' then the parent application will expect a
  53.      resource line of the form:
  54.  
  55.      *SGI_Brightness___Contrast_Video_Filter: Brightness and Contrast
  56.  
  57.      If your plugin has a user interface you may also specifiy localized
  58.      string labels for buttons and dialogs in _r_f - just be careful to
  59.      sufficiently qualify the resource names so you don't interfere with any
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddmmmmFFFFXXXXMMMMeeeerrrrggggeeeeRRRReeeessssoooouuuurrrrcccceeeessss((((3333ddddmmmm))))                                ddddmmmmFFFFXXXXMMMMeeeerrrrggggeeeeRRRReeeessssoooouuuurrrrcccceeeessss((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      resources which other plugins may specify.  We recommended you use
  75.      _P_K__U_n_i_q_u_e_P_r_e_f_i_x as part of the label for your dialog and specify that
  76.      with every resource.
  77.  
  78.      ddddmmmmFFFFXXXXMMMMeeeerrrrggggeeeeRRRReeeessssoooouuuurrrrcccceeeessss should be called in your _P_R_X__P_l_u_g_i_n_P_r_o_p_e_r_t_i_e_s
  79.      function.  This guarantees that resources will have been merged before
  80.      the parent application searches the resource database for your localized
  81.      plugin name.
  82.  
  83.      Plugin resource files should be located in:
  84.  
  85.      /usr/lib/X11/app-defaults/dmedia/plugins/premiere/_r_f
  86.  
  87.      with optional locale-specific versions in:
  88.  
  89.      /usr/lib/X11/$LANG/app-defaults/dmedia/plugins/premiere/_r_f
  90.  
  91.      ddddmmmmFFFFXXXXMMMMeeeerrrrggggeeeeRRRReeeessssoooouuuurrrrcccceeeessss searches for your resource file using the same rules
  92.      as XXXXttttRRRReeeessssoooollllvvvveeeePPPPaaaatttthhhhnnnnaaaammmmeeee with a file type of ``app-
  93.      defaults/dmedia/plugins/premiere''.
  94.  
  95.      For assistance in debugging set the plugin property _P_K__D_e_b_u_g_g_i_n_g to _T_r_u_e
  96.      and observe messages printed to stderr.
  97.  
  98. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  99.      Returns _D_M__S_U_C_C_E_S_S on success and _D_M__F_A_I_L_U_R_E otherwise.
  100.  
  101.  
  102. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  103.      dmPMGetLocalName(3dm), XtResolvePathname(Xt).
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.